home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / piclb191.zip / PL.HLP < prev    next >
Text File  |  1991-12-04  |  35KB  |  949 lines
  1. PL.HLP : Help file for Piclab 1.91
  2. Compiled 12/3/91
  3.  
  4. ~MAKEPAL
  5.  
  6. Syntax: MAKEPAL
  7.  
  8. Makes a palette appropriate for the NEW buffer.  Operates on only
  9. true-color images.  The variable PALETTE determines the number of
  10. colors in the new map, and the MAKEPAL command picks that many colors
  11. to best fit those in the image.
  12.  
  13. The MAP command must be used to map the image onto the palette.
  14.  
  15. ~EGAPAL
  16.  
  17. Syntax: EGAPAL
  18.  
  19. Makes a 16-of-64-color palette appropriate for the NEW buffer.
  20. Operates on only true-color images.  This is designed primarily for
  21. reducing full-color images to a form better suited for display on
  22. an IBM EGA or similar device.
  23.  
  24. The MAP command must be used to map the image onto the palette.
  25.  
  26. ~MAP
  27.  
  28. Syntax: MAP
  29.  
  30. Maps NEW buffer onto the current palette.  Operates only on true-color
  31. images, and produces a color-mapped image.  The variable DITHER
  32. determines whether each pixel is simply mapped onto the nearest color
  33. in the map, or whether dithering is used to achieve a more accurate
  34. mapping.  DITHER defaults to ON, and is recommended for most uses.
  35.  
  36. The MAKEPAL command should be used to create the best possible palette
  37. for the image before mapping, but any palette may be used for special
  38. purposes such as mapping several images to the same palette.
  39.  
  40. ~PLOAD
  41.  
  42. Syntax: PLOAD file [offset [count]]
  43.  
  44. Loads a MAP file into the current palette.  First argument is the name
  45. of the MAP file which is assumed to be in the PICDIR directory.  If a
  46. second argument is given, the palette is loaded starting at that index.
  47. If a third argument is given, only that many colors are loaded.
  48.  
  49. MAP files are plain text files that contain the RGB values for each
  50. palette index on one line.
  51.  
  52. ~PSAVE
  53.  
  54. Syntax: PSAVE file [offset [count]]
  55.  
  56. Saves a MAP file from the current palette.  First argument is the name
  57. of the MAP file which is assumed to be in the PICDIR directory.  If a
  58. second argument is given, the palette is loaded starting at that index.
  59. If a third argument is given, only that many colors are loaded.
  60.  
  61. This can be used to save a palette created with MAKEPAL so that it need
  62. not be calculated again, or so that it can be used with other images.
  63.  
  64. MAP files are plain text files that contain the RGB values for each
  65. palette index on one line.
  66.  
  67. ~GRAYPAL
  68.  
  69. Syntax: GRAYPAL file [offset [count]]
  70.  
  71. Makes the specified MAP file the default colors used when displaying
  72. monochrome images or full-color images on a VGA.  The default colors
  73. are equivalent to GAMMA1.MAP, but GAMMA2.MAP and PSEUDO.MAP can be
  74. useful in some situations.
  75.  
  76. MAP files are plain text files that contain the RGB values for each
  77. palette index on one line.
  78.  
  79. ~UNMAP
  80.  
  81. Syntax: UNMAP
  82.  
  83. Produces a true-color image from a color-mapped one.  This must be done
  84. before applying true-color transformations such as rescaling.  After
  85. transformations have been performed in true-color, the image may be
  86. reduced to a color-mapped one again with the MAKEPAL and MAP commands.
  87.  
  88. ~HELP
  89.  
  90. Syntax: HELP [subject]
  91.  
  92. Looks like you have figured this one out already.
  93.  
  94. ~CALL
  95.  
  96. Syntax: CALL program [args]...
  97.  
  98. Calls the external program named by its first argument passing along
  99. any subsequent arguments to that program.  Many programs do not
  100. release all of the memory given to them when they terminate, so
  101. Piclab will reserve a large portion of memory for itself before
  102. calling a program.  If you do not have much more memory than Piclab
  103. reserves, this may result in the program not being able to run in the
  104. memory left.
  105.  
  106. If this is a problem, you can use the DOS or SHELL commands to exit
  107. to DOS with all of the free memory available.
  108.  
  109. ~CANCEL
  110.  
  111. Syntax: CANCEL
  112.  
  113. Cancels the most recent operation.  If there are point
  114. transformations pending that have not yet been saved with the
  115. TRANSFORM command, these are cancelled and no changes are made to the
  116. edit buffers.  Otherwise, the NEW and OLD buffers are exchanged.
  117.  
  118. There are some operations (like SAVE) that do not alter the edit
  119. buffers.  If one of these operations was the last one performed, UNDO
  120. will undo the operation before that.  No arguments.
  121.  
  122. ~UNDO
  123.  
  124. Syntax: UNDO
  125.  
  126. Cancels the most recent operation.  If there are point
  127. transformations pending that have not yet been saved with the
  128. TRANSFORM command, these are cancelled and no changes are made to the
  129. edit buffers.  Otherwise, the NEW and OLD buffers are exchanged.
  130.  
  131. There are some operations (like SAVE) that do not alter the edit
  132. buffers.  If one of these operations was the last one performed, UNDO
  133. will undo the operation before that.  No arguments.
  134.  
  135. ~SHELL
  136.  
  137. Syntax: SHELL [command]
  138.  
  139. Calls up the DOS command line.  All available memory is released to
  140. DOS when this command is given, and is reclaimed when DOS is exited.
  141. For this reason, some programs that cannot be CALLed may be run from
  142. with DOS.
  143.  
  144. Any arguments to this command will be passed to the system as a
  145. command line, and will cause it to return immediately after the
  146. command is done.  One particularly useful action of this program is
  147. "SHELL COPY /B PDAT PRN", which copies the print file to the printer.
  148. "SHELL DIR" can be used to view file directories when you want to see
  149. all files, not just pictures.
  150.  
  151. ~DOS
  152.  
  153. Syntax: DOS [command]
  154.  
  155. Calls up the DOS command line.  All available memory is released to
  156. DOS when this command is given, and is reclaimed when DOS is exited.
  157. For this reason, some programs that cannot be CALLed may be run from
  158. with DOS.
  159.  
  160. Any arguments to this command will be passed to the system as a
  161. command line, and will cause it to return immediately after the
  162. command is done.  One particularly useful action of this program is
  163. "DOS COPY /B PDAT PRN", which copies the print file to the printer.
  164. "DOS DIR" can be used to view file directories when you want to see
  165. all files, not just pictures.
  166.  
  167. ~QUIT
  168.  
  169. Syntax: QUIT [flag]
  170.  
  171. Exits Piclab.  If there is a point transformation pending, it must be
  172. cancelled or saved before exiting.  If the exit command is given any
  173. arguments, it exits immediately regardless of pending transformations.
  174.  
  175. Inside a program, QUIT merely sets a flag so that Piclab will exit after
  176. the program is complete.
  177.  
  178. ~EXIT
  179.  
  180. Syntax: EXIT [flag]
  181.  
  182. Exits Piclab.  If there is a point transformation pending, it must be
  183. cancelled or saved before exiting.  If the exit command is given any
  184. arguments, it exits immediately regardless of pending transformations.
  185.  
  186. Inside a program, EXIT merely sets a flag so that Piclab will exit after
  187. the program is complete.
  188.  
  189. ~LIST
  190.  
  191. Syntax: LIST [item]
  192.  
  193. If given without an argument, shows what things may can be listed.
  194. If one of these things (e.g. FORMATS, COMMANDS, BUFFERS) is given as
  195. an argument, the appropriate items are listed.  Especially useful are
  196. LIST COMMANDS if you forget the name of a command you are looking for
  197. and LIST BUFFERS to check the size and format of the image in the OLD
  198. and NEW edit buffers.
  199.  
  200. ~PAUSE
  201.  
  202. Syntax: PAUSE [time]
  203.  
  204. With no arguments, Piclab waits for a key to be pressed before
  205. continuing.  If one argument is given, Piclab waits for that number
  206. of seconds (but will break early if a key is pressed).  This is for
  207. use within programs.
  208.  
  209. ~PRINT
  210.  
  211. Syntax: PRINT [x-offset [y-offset]]
  212.  
  213. Prints the image in the NEW buffer into the file specified by the
  214. PRINTFILE variable.  The current setting of the PRINTER variable
  215. determines what codes are sent to the file.
  216.  
  217. For hard-to-explain reasons, the current release of Piclab does not
  218. allow the use of a device name such as PRN in the PRINTFILE
  219. variable.  Images must therefore be printed to disk and copied to the
  220. printer with DOS.
  221.  
  222. If arguments are given, the first two are used as the X and Y offsets
  223. of the first dot to print on the first page of output.
  224.  
  225. ~RUN
  226.  
  227. Syntax: RUN program [ECHO]
  228.  
  229. Takes one argument--the name of a text file containing Piclab
  230. commands.  These are interpreted as if they had been typed from the
  231. command line, but they are not echoed, and messages are turned off
  232. while a program runs.  If a second argument to the RUN command is the
  233. word ECHO, messages are not turned off.
  234.  
  235. A